home *** CD-ROM | disk | FTP | other *** search
/ IRIX Base Documentation 2001 May / SGI IRIX Base Documentation 2001 May.iso / usr / share / catman / p_man / cat3 / f90 / pxfkill.z / pxfkill
Encoding:
Text File  |  1998-10-30  |  4.3 KB  |  106 lines
  1. PXFKILL(3F)                                           Last changed: 2-26-98
  2.  
  3.  
  4. NNAAMMEE
  5.      PPXXFFKKIILLLL - Sends a signal to a process or group of processes
  6.  
  7. SSYYNNOOPPSSIISS
  8.      SSUUBBRROOUUTTIINNEE PPXXFFKKIILLLL ((_i_p_i_d,, _i_s_i_g,, _i_e_r_r_o_r))
  9.      IINNTTEEGGEERR _i_p_i_d,, _i_s_i_g,, _i_e_r_r_o_r
  10.  
  11. IIMMPPLLEEMMEENNTTAATTIIOONN
  12.      UNICOS, UNICOS/mk, and IRIX systems
  13.  
  14. SSTTAANNDDAARRDDSS
  15.      IEEE standard interface for FORTRAN 77
  16.  
  17. DDEESSCCRRIIPPTTIIOONN
  18.      The PPXXFFKKIILLLL subroutine uses the kkiillll(2) system call to send a signal
  19.      to a process or group of processes.
  20.  
  21.      The following is a list of valid arguments for this routine:
  22.  
  23.      _i_p_i_d      A default integer input variable containing the process PID.
  24.                The signal will be sent to a process or group of processes
  25.                specified by _i_p_i_d.
  26.  
  27.      _i_s_i_g      A default integer output variable containing the signal to
  28.                be sent.
  29.  
  30.      _i_e_r_r_o_r    A default integer output variable that contains zero if
  31.                PPXXFFKKIILLLL was successful and nonzero if PPXXFFKKIILLLL was not
  32.                successful.
  33.  
  34.      This subroutine may return any of the following error values:
  35.  
  36.      EEIINNVVAALL         The value of the _i_s_i_g argument is an invalid or
  37.                     unsupported signal number.
  38.  
  39.      EEPPEERRMM          The process does not have permission to send the _i_s_i_g
  40.                     signal to any receiving process.
  41.  
  42.      EESSRRCCHH          No process or process group can be found corresponding
  43.                     to the process ID specified by _i_p_i_d.
  44.  
  45.      On UNICOS and UNICOS/mk systems, the subroutine may also return:
  46.  
  47.      EEPPEERRMM          The value of the _i_p_i_d argument is 1 (proc1) and _i_s_i_g is
  48.                     either SSIIGGKKIILLLL or SSIIGGSSTTOOPP.
  49.  
  50.      On IRIX systems, it may also return:
  51.  
  52.      EEPPEERRMM          The value of the _i_p_i_d argument is 1 (proc1) and _i_s_i_g is
  53.                     SSIIGGKKIILLLL.
  54.  
  55.      EESSRRCCHH          The process group was given as 0 but the sending
  56.                     process does not have a process group
  57.  
  58.      On IRIX systems, this routine is in lliibbffoorrttrraann..ssoo which is linked by
  59.      default when compiling programs with the MIPSpro 7 Fortran 90 compiler
  60.      or when compiling programs with the --ccrraayylliibbss option to the MIPSpro
  61.      7.2 F77 compiler.
  62.  
  63.      When using the CF90 compiler or MIPSpro 7 Fortran 90 compiler on
  64.      UNICOS, UNICOS/mk, or IRIX systems, all arguments must be of default
  65.      kind unless documented otherwise. On UNICOS and UNICOS/mk, default
  66.      kind is KKIINNDD==88 for integer, real, complex, and logical arguments; on
  67.      IRIX systems, the default kind is KKIINNDD==44.
  68.  
  69. NNOOTTEESS
  70.      Replace any Fortran reference to kkiillll(()) with a subroutine call to
  71.      PPXXFFKKIILLLL.
  72.  
  73. EEXXAAMMPPLLEESS
  74.               program pxftest
  75.               integer ipid, isig, ierror
  76.  
  77.               CALL PXFFORK(ipid,ierror)
  78.               if (ierror .ne. 0) then
  79.                  print *,'FAILED: PXFFORK call failed with error = ',ierror
  80.                  print *,'ipid=',ipid
  81.               else
  82.                  print *,'PASSED: PXFFORK call returned no error'
  83.               endif
  84.               call PXFCONST("SIGKILL",isig,ierror)
  85.               if(ierror .ne. 0) then
  86.                  print *, 'PXFCONST FAILED', ierror
  87.                  print *,'isig=',isig
  88.               else
  89.                  print *, 'PXFCONST PASSED'
  90.               endif
  91.               CALL PXFKILL(ipid, isig, ierror)
  92.               if (ierror .ne. 0) then
  93.                  print *,'FAILED: PXFKILL call failed with error = ',ierror
  94.                  print *,'ipid=',ipid
  95.                  print *,'isig=',isig
  96.               else
  97.                  print *,'PASSED: PXFKILL call returned no error'
  98.               endif
  99.               end
  100.  
  101. SSEEEE AALLSSOO
  102.      kkiillll(2)
  103.  
  104.      _A_p_p_l_i_c_a_t_i_o_n _P_r_o_g_r_a_m_m_e_r'_s _L_i_b_r_a_r_y _R_e_f_e_r_e_n_c_e _M_a_n_u_a_l, publication
  105.      SR-2165, for the printed version of this man page.
  106.